home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldreadst.z / ldreadst
Encoding:
Text File  |  2002-10-03  |  2.4 KB  |  59 lines
  1. LDREADST(3X)                                          Last changed: 11-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      llddrreeaaddsstt - Reads symbol table information
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  10.      ##iinncclluuddee <<ssyymmss..hh>>
  11.      ##iinncclluuddee <<llddffccnn..hh>>
  12.  
  13.      iinntt llddrreeaaddsstt((LLDDFFIILLEE ** _l_d_p_t_r,, iinntt _f_l_a_g_s ""));;""
  14.  
  15. IIMMPPLLEEMMEENNTTAATTIIOONN
  16.      IRIX systems (o32 ABI only)
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      llddrreeaaddsstt reads in the portions of the symbol table implied by the
  20.      _f_l_a_g_s argument.  A _f_l_a_g_s argument of --11 reads in the entire symbol
  21.      table.  Since the other symbol table routines, for example, llddttbbrreeaadd,
  22.      ensure that the relevant portions of the symbol table have been read
  23.      in, you need not call llddrreeaaddsstt to use the other routines.
  24.      llddrreeaaddsstt((llddppttrr,,--11)) would simply ensure the whole symbol table is read
  25.      in at once, which is not necessary.
  26.  
  27.      llddrreeaaddsstt is useful, however.  You can test for the existence of symbol
  28.      table information in a file in the following way:
  29.  
  30.           char *filename;
  31.           LDFILE *ldptr;
  32.           ldptr = ldopen(filename, (LDFILE *)0);
  33.           if(ldptr == NULL) {
  34.             /* No such file exists */
  35.           } else {
  36.             /* This is not the _only_ way one could test for
  37.             ** the existence of the symbol table.
  38.             */
  39.             if(ldreadst(pchdr,-1) == FAILURE) {
  40.                /* This binary has no symbol table */
  41.             }
  42.           }
  43.  
  44.      llddrreeaaddsstt returns SSUUCCCCEESSSS if it has read in the symbol table
  45.      successfully or FFAAIILLUURREE if it cannot.  If an symbol table has been
  46.      truncated or damaged, there is a small probability that llddrreeaaddsstt will
  47.      core dump rather than return FFAAIILLUURREE.
  48.  
  49.      The program must be loaded with the object file access routine library
  50.      lliibbmmlldd..aa.
  51.  
  52. SSEEEE AALLSSOO
  53.      llddooppeenn(3X), llddcclloosse(3X)
  54.  
  55.      iinnttrroo(4), llddffccnn(4)
  56.  
  57.      This man page is available only online.
  58.  
  59.